home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / rcs.z / rcs
Encoding:
Text File  |  2002-10-03  |  14.3 KB  |  331 lines
  1.  
  2.  
  3.  
  4. RRRRCCCCSSSS((((1111))))                                                                  RRRRCCCCSSSS((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      rcs - change RCS file attributes
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      rrrrccccssss [ _o_p_t_i_o_n_s ] _f_i_l_e ...
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      rrrrccccssss creates new RCS files or changes attributes of existing ones.  An RCS
  16.      file contains multiple revisions of text, an access list, a change log,
  17.      descriptive text, and some control attributes.  For rrrrccccssss to work, the
  18.      caller's login name must be on the access list, except if the access list
  19.      is empty, the caller is the owner of the file or the superuser, or the ----iiii
  20.      option is present.
  21.  
  22.      Pathnames matching an RCS suffix denote RCS files; all others denote
  23.      working files.  Names are paired as explained in cccciiii(1).  Revision numbers
  24.      use the syntax described in cccciiii(1).
  25.  
  26. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  27.      ----iiii   Create and initialize a new RCS file, but do not deposit any
  28.           revision.  If the RCS file has no path prefix, try to place it first
  29.           into the subdirectory ....////RRRRCCCCSSSS, and then into the current directory.
  30.           If the RCS file already exists, print an error message.
  31.  
  32.      ----aaaa_l_o_g_i_n_s
  33.           Append the login names appearing in the comma-separated list _l_o_g_i_n_s
  34.           to the access list of the RCS file.
  35.  
  36.      ----AAAA_o_l_d_f_i_l_e
  37.           Append the access list of _o_l_d_f_i_l_e to the access list of the RCS
  38.           file.
  39.  
  40.      ----eeee[_l_o_g_i_n_s]
  41.           Erase the login names appearing in the comma-separated list _l_o_g_i_n_s
  42.           from the access list of the RCS file.  If _l_o_g_i_n_s is omitted, erase
  43.           the entire access list.
  44.  
  45.      ----bbbb[_r_e_v]
  46.           Set the default branch to _r_e_v.  If _r_e_v is omitted, the default
  47.           branch is reset to the (dynamically) highest branch on the trunk.
  48.  
  49.      ----cccc_s_t_r_i_n_g
  50.           sets the comment leader to _s_t_r_i_n_g.  An initial cccciiii, or an rrrrccccssss ----iiii
  51.           without ----cccc, guesses the comment leader from the suffix of the
  52.           working filename.
  53.  
  54.           This option is obsolescent, since RCS normally uses the preceding
  55.           $$$$LLLLoooogggg$$$$ line's prefix when inserting log lines during checkout (see
  56.           ccccoooo(1)).  However, older versions of RCS use the comment leader
  57.           instead of the $$$$LLLLoooogggg$$$$ line's prefix, so if you plan to access a file
  58.           with both old and new versions of RCS, make sure its comment leader
  59.           matches its $$$$LLLLoooogggg$$$$ line prefix.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. RRRRCCCCSSSS((((1111))))                                                                  RRRRCCCCSSSS((((1111))))
  71.  
  72.  
  73.  
  74.      ----kkkk_s_u_b_s_t
  75.           Set the default keyword substitution to _s_u_b_s_t.  The effect of
  76.           keyword substitution is described in ccccoooo(1).  Giving an explicit ----kkkk
  77.           option to ccccoooo, rrrrccccssssddddiiiiffffffff, and rrrrccccssssmmmmeeeerrrrggggeeee overrides this default.  Beware
  78.           rrrrccccssss ----kkkkvvvv, because ----kkkkvvvv is incompatible with ccccoooo ----llll.  Use rrrrccccssss ----kkkkkkkkvvvv to
  79.           restore the normal default keyword substitution.
  80.  
  81.      ----llll[_r_e_v]
  82.           Lock the revision with number _r_e_v.  If a branch is given, lock the
  83.           latest revision on that branch.  If _r_e_v is omitted, lock the latest
  84.           revision on the default branch.  Locking prevents overlapping
  85.           changes.  If someone else already holds the lock, the lock is broken
  86.           as with rrrrccccssss ----uuuu (see below).
  87.  
  88.      ----uuuu[_r_e_v]
  89.           Unlock the revision with number _r_e_v.  If a branch is given, unlock
  90.           the latest revision on that branch.  If _r_e_v is omitted, remove the
  91.           latest lock held by the caller.  Normally, only the locker of a
  92.           revision may unlock it.  Somebody else unlocking a revision breaks
  93.           the lock.  This causes a mail message to be sent to the original
  94.           locker.  The message contains a commentary solicited from the
  95.           breaker.  The commentary is terminated by end-of-file or by a line
  96.           containing .... by itself.
  97.  
  98.      ----LLLL   Set locking to _s_t_r_i_c_t.  Strict locking means that the owner of an
  99.           RCS file is not exempt from locking for checkin.  This option should
  100.           be used for files that are shared.
  101.  
  102.      ----UUUU   Set locking to non-strict.  Non-strict locking means that the owner
  103.           of a file need not lock a revision for checkin.  This option should
  104.           _n_o_t be used for files that are shared.  Whether default locking is
  105.           strict is determined by your system administrator, but it is
  106.           normally strict.
  107.  
  108.      ----mmmm_r_e_v::::_m_s_g
  109.           Replace revision _r_e_v's log message with _m_s_g.
  110.  
  111.      ----MMMM   Do not send mail when breaking somebody else's lock.  This option is
  112.           not meant for casual use; it is meant for programs that warn users
  113.           by other means, and invoke rrrrccccssss ----uuuu only as a low-level lock-breaking
  114.           operation.
  115.  
  116.      ----nnnn_n_a_m_e[::::[_r_e_v]]
  117.           Associate the symbolic name _n_a_m_e with the branch or revision _r_e_v.
  118.           Delete the symbolic name if both :::: and _r_e_v are omitted; otherwise,
  119.           print an error message if _n_a_m_e is already associated with another
  120.           number.  If _r_e_v is symbolic, it is expanded before association.  A
  121.           _r_e_v consisting of a branch number followed by a .... stands for the
  122.           current latest revision in the branch.  A :::: with an empty _r_e_v stands
  123.           for the current latest revision on the default branch, normally the
  124.           trunk.  For example, rrrrccccssss ----nnnn_n_a_m_e:::: RRRRCCCCSSSS////**** associates _n_a_m_e with the
  125.           current latest revision of all the named RCS files; this contrasts
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. RRRRCCCCSSSS((((1111))))                                                                  RRRRCCCCSSSS((((1111))))
  137.  
  138.  
  139.  
  140.           with rrrrccccssss ----nnnn_n_a_m_e::::$$$$ RRRRCCCCSSSS////**** which associates _n_a_m_e with the revision
  141.           numbers extracted from keyword strings in the corresponding working
  142.           files.
  143.  
  144.      ----NNNN_n_a_m_e[::::[_r_e_v]]
  145.           Act like ----nnnn, except override any previous assignment of _n_a_m_e.
  146.  
  147.      ----oooo_r_a_n_g_e
  148.           deletes ("outdates") the revisions given by _r_a_n_g_e.  A range
  149.           consisting of a single revision number means that revision.  A range
  150.           consisting of a branch number means the latest revision on that
  151.           branch.  A range of the form _r_e_v_1::::_r_e_v_2 means revisions _r_e_v_1 to _r_e_v_2
  152.           on the same branch, ::::_r_e_v means from the beginning of the branch
  153.           containing _r_e_v up to and including _r_e_v, and _r_e_v::::  means from
  154.           revision _r_e_v to the end of the branch containing _r_e_v.  None of the
  155.           outdated revisions may have branches or locks.
  156.  
  157.      ----qqqq   Run quietly; do not print diagnostics.
  158.  
  159.      ----IIII   Run interactively, even if the standard input is not a terminal.
  160.  
  161.      ----ssss_s_t_a_t_e[::::_r_e_v]
  162.           Set the state attribute of the revision _r_e_v to _s_t_a_t_e.  If _r_e_v is a
  163.           branch number, assume the latest revision on that branch.  If _r_e_v is
  164.           omitted, assume the latest revision on the default branch.  Any
  165.           identifier is acceptable for _s_t_a_t_e.  A useful set of states is EEEExxxxpppp
  166.           (for experimental), SSSSttttaaaabbbb (for stable), and RRRReeeellll (for released).  By
  167.           default, cccciiii(1) sets the state of a revision to EEEExxxxpppp.
  168.  
  169.      ----tttt[_f_i_l_e]
  170.           Write descriptive text from the contents of the named _f_i_l_e into the
  171.           RCS file, deleting the existing text.  The _f_i_l_e pathname may not
  172.           begin with ----.  If _f_i_l_e is omitted, obtain the text from standard
  173.           input, terminated by end-of-file or by a line containing .... by
  174.           itself.  Prompt for the text if interaction is possible; see ----IIII.
  175.           With ----iiii, descriptive text is obtained even if ----tttt is not given.
  176.  
  177.      ----tttt----_s_t_r_i_n_g
  178.           Write descriptive text from the _s_t_r_i_n_g into the RCS file, deleting
  179.           the existing text.
  180.  
  181.      ----TTTT   Preserve the modification time on the RCS file unless a revision is
  182.           removed.  This option can suppress extensive recompilation caused by
  183.           a mmmmaaaakkkkeeee(1) dependency of some copy of the working file on the RCS
  184.           file.  Use this option with care; it can suppress recompilation even
  185.           when it is needed, i.e. when a change to the RCS file would mean a
  186.           change to keyword strings in the working file.
  187.  
  188.      ----VVVV   Print RCS's version number.
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. RRRRCCCCSSSS((((1111))))                                                                  RRRRCCCCSSSS((((1111))))
  203.  
  204.  
  205.  
  206.      ----VVVV_n  Emulate RCS version _n.  See ccccoooo(1) for details.
  207.  
  208.      ----xxxx_s_u_f_f_i_x_e_s
  209.           Use _s_u_f_f_i_x_e_s to characterize RCS files.  See cccciiii(1) for details.
  210.  
  211.      ----zzzz_z_o_n_e
  212.           Use _z_o_n_e as the default time zone.  This option has no effect; it is
  213.           present for compatibility with other RCS commands.
  214.  
  215.      At least one explicit option must be given, to ensure compatibility with
  216.      future planned extensions to the rrrrccccssss command.
  217.  
  218. CCCCOOOOMMMMPPPPAAAATTTTIIIIBBBBIIIILLLLIIIITTTTYYYY
  219.      The ----bbbb_r_e_v option generates an RCS file that cannot be parsed by RCS
  220.      version 3 or earlier.
  221.  
  222.      The ----kkkk_s_u_b_s_t options (except ----kkkkkkkkvvvv) generate an RCS file that cannot be
  223.      parsed by RCS version 4 or earlier.
  224.  
  225.      Use rrrrccccssss ----VVVV_n to make an RCS file acceptable to RCS version _n by discarding
  226.      information that would confuse version _n.
  227.  
  228.      RCS version 5.5 and earlier does not support the ----xxxx option, and requires
  229.      a ,,,,vvvv suffix on an RCS pathname.
  230.  
  231. FFFFIIIILLLLEEEESSSS
  232.      rrrrccccssss accesses files much as cccciiii(1) does, except that it uses the effective
  233.      user for all accesses, it does not write the working file or its
  234.      directory, and it does not even read the working file unless a revision
  235.      number of $$$$ is specified.
  236.  
  237. EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  238.      RRRRCCCCSSSSIIIINNNNIIIITTTT
  239.           options prepended to the argument list, separated by spaces.  See
  240.           cccciiii(1) for details.
  241.  
  242. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  243.      The RCS pathname and the revisions outdated are written to the diagnostic
  244.      output.  The exit status is zero if and only if all operations were
  245.      successful.
  246.  
  247. IIIIDDDDEEEENNNNTTTTIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  248.      Author: Walter F. Tichy.
  249.      Revision Number: 5.7; Release Date: 1998/01/12.
  250.      Copyright c 1982, 1988, 1989 by Walter F. Tichy.
  251.      Copyright c 1990, 1991, 1992, 1993, 1994, 1995 by Paul Eggert.
  252.  
  253. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  254.      co(1), ci(1), ident(1), rcsdiff(1), rcsintro(1), rcsmerge(1), rlog(1),
  255.      rcsfile(4), RCSsource(5)
  256.      Walter F. Tichy, RCS--A System for Version Control, _S_o_f_t_w_a_r_e--_P_r_a_c_t_i_c_e &
  257.      _E_x_p_e_r_i_e_n_c_e 11115555, 7 (July 1985), 637-654.
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. RRRRCCCCSSSS((((1111))))                                                                  RRRRCCCCSSSS((((1111))))
  269.  
  270.  
  271.  
  272. BBBBUUUUGGGGSSSS
  273.      A catastrophe (e.g. a system crash) can cause RCS to leave behind a
  274.      semaphore file that causes later invocations of RCS to claim that the RCS
  275.      file is in use.  To fix this, remove the semaphore file.  A semaphore
  276.      file's name typically begins with ,,,, or ends with ____.
  277.  
  278.      The separator for revision ranges in the ----oooo option used to be ---- instead
  279.      of ::::, but this leads to confusion when symbolic names contain ----.  For
  280.      backwards compatibility rrrrccccssss ----oooo still supports the old ---- separator, but it
  281.      warns about this obsolete use.
  282.  
  283.      Symbolic names need not refer to existing revisions or branches.  For
  284.      example, the ----oooo option does not remove symbolic names for the outdated
  285.      revisions; you must use ----nnnn to remove the names.
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                                                         PPPPaaaaggggeeee 5555
  328.  
  329.  
  330.  
  331.